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NET2890 PROGRAMMING FLOWCHART 


This flowchart presents a simple, yet complete 
NET2890 programming example. It is a good case 
study for programmers that are new to the 
NET2890. 


The flowchart applies to a simple bus-powered USB 
device that supports: 

- Enumeration 

- Control transfers (read and write) 

- Data transfers (IN and OUT) 


The flowchart is based on an interrupt-driven CPU. 
After initialization, all USB events are handled 
under interrupt control. 


For brevity, several limitations apply to the flowchart: 


- Only two NET2890 data endpoints are used 


When the host successfully reads the packet, 
an interrupt (if enabled) is generated. The 
NET2890 automatically handles timing, PID 
generation, CRC, bit stuffing, retries, etc. 
Firmware is responsible for all data content 
however. For example, when a Setup 
Request successfully arrives, firmware must 
examine the request, and generate an 
appropriate response. Descriptor content is 
completely controlled by firmware. When the 
host requests a descriptor, firmware loads 
the descriptor content into a FIFO for the 
host to read. Note that an endpoint's descriptor 
content must correspond to the endpoint's 
programming in the NET2890. 


- Minimal number of USB requests are supported Table of Contents 
- Simple buffer management 
-No DMA - CPU Reset Page 3 
With hardware and software support, these : ea ee 
ited! - SetupRequest ‘age 
limitations can be removed. Anepauneee pane 6 
. - GetConfDesc Page 7 
NET2890: The Programmer's Perspective: - EpO0TransmitPkt Page 8 
The NET2890 is a USB interface controller designed - EpOPktSentHandler, SetAddress = Page 9 
to abstract firmware from low-level complexities of Spree fe em 
USB. For example, to return a packet of data to the . EpAHandler, EpBHandler pan 12 
host, firmware simply writes data to a FIFO, - ReceivePkt Page 13 
and (optionally) sets a bit indicating that the ~TransmitPkt Page 14 
NET2890 can send the contents of the FIFO to the 2 EpAlnitEpBinit: Page 1) 
host - Sample Enumeration Sequences Page 16 
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At a minimum, programmers should be familiar with 
USB specification sections 8.5 and 9.3 - 9.6. 


ENUMERATION: 

For many USB devices, the most difficult task is 
enumeration. A device must examine the contents 
of the Setup Request and respond accordingly. 
This flowchart supports the minimum set of Setup 
Requests that are required for enumeration: 

- Get Device Descriptor 

- Get Configuration Descriptor 

- Set Address 

- Set Configuration 

If the program does not recognize a Setup Request 
it will instruct the NET2890 to stall endpoint 0. 


CONTROL TRANSFERS: 

In this flowchart, Control Read data transfers return 
standard descriptors to the host during enumeration. 
The model can easily be extended for any Control 
Read data transfer, including Class or Vendor 
Specific requests. 


Control Write data transfers are not required for 
enumeration, however the flowchart includes Control 
Write data transfer programming for completeness. 
The model can easily be extended for any Control 
Write data transfer, including Class or Vendor 
Specific requests. 


DATA TRANSFERS: 

For brevity, this example uses only two 
NET2890 data endpoints. Endpoint A is 
arbitrarily programmed as a 64-byte BULK OUT 
endpoint, and endpoint B is programmed as a 
64-byte BULK IN endpoint. Note that a NET2890 
data endpoint can be configured as any type 
(BULK, ISO, or INT); size (1023 bytes max); or 
direction (IN or OUT). 


Data transfers are somewhat artificial in this 
program. A real USB device typically has a 
mechanism for transfering data from a USB 
endpoint to an electronic unit (such as a 
MODEM) and vice-versa. This example, 
however, simply transfers data to or from the 
device's memory buffers. Once a receive buffer 
becomes full or a transmit buffer becomes 
empty, the endpoint will NAK. 


CHIP ERRATA 
This flowchart includes a workaround for 
NET2890 errata 630-0057-0401. 


DISCLAIMER 

NetChip's NET2890 design team has made 
every effort to make this document useful, 
accurate and complete. You should recognize, 
however, that errors and ommisions may exist. 
If you have problems with this document, please 
contact NetChip Technology, Inc. 
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NET2890 Initialization Sequence 


Start here: 
Local CPU is reset due to USB 


cable being plugged in, Root Port 
Reset or push-button reset. te CPU Reset 


Basic system initialization: 
POST, memory, stack, etc. 


Select IRQENB1 in Indexed Register (IDXADDR1=0x02) 
Enable Endpoint 0, A and B interrupts in IRQENB1 (IDXDATA1=0x07) 


Select IRQENB2 in Indexed Register (IDXADDR1=0x03) 
Enable Setup Packet Interrupt IRQENB2 (IDXDATA1=0x40) 


Select Endpoint 0's Paged Register Set (PAGESEL=0x00) 
Enable Data Packet Received, Data Packet Transmitted and Data Token /N interrupts (EPIRQENB=0x34) 
Set FIFO Valid Mode and FIFO Flush (FIFOCTL=0x60) 


Select EPOPKTSIZLSB in Indexed Register (IDXADDR1=0x10) 


Set EPO maximum packet size (IDXDATA1=Ep0MaxPktSize) 


EpOMaxPktSize isa * 
constant. It can be 


L v 

either 8 or 16. (The : 
NET2890 default is 8.) EpAlnit 
; Page 15 


Vv 
EpBlnit 


Page 15 


Configure CPU interrupt subsystem 
as needed to vector a NET2890 
interrupt request (IRQ#) to the 
Net2890Interrupt routine (Page 4) 


Loop forever doing nothing. > 
Net2890Interrupthandles all - y 
enumeration and transfer events. Idle 
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| Net2890Interrupt ) 


Default 


Endpoint 0 Interrupt 


When the NET2890 IRQ# pin is 
asserted, the interrupt subsystem 
transfers CPU control to here. 


Endpoint A Interrupt (IRQSTAT1[1]==1) — | EpAHandler 
fa Page 12 
o 
& 
& 
5 
g Endpoint B Interrupt (IRQSTAT1[2]==1) —> EpBHandler 
S Page 12 
g 
n 
<o} 
3 
$ 


Setup Packet Interrupt (IRQSTATZ6J=-1) _» | oetupRequest 


Page 5 


Notice that a Setup Packet 
‘Interrupt is handled before 
-an Endpoint 0 Interrupt 


Yes 


" EpOHandler 


(IRQSTAT1[0]==1) 
2 


No 


Suspend Request 
(IRQSTAT2[1]==1) 
? 


Yes 
v 


No—> 


Page 11 


PROGRAM 
FAULT!! 


Clear Suspend Request and Resume Interrupt Status, 


and Set Suspend Control (IRQSTAT2=0x13) 


v 


Reduce local power and power down CPU 


This simple example does not handle other 
NET2890 interrupt events. A real device may need 
to respond to Root Port Reset Interrupt and other 
interrupt events here. 

All enabled interrupts must have handlers. If 


‘the source of an enabled interrupt is not cleared 


(by writing a'1' to appropriate bits in IRQSTAT1 or 
IRQSTAT2) the NET2890 will not de-assert IRQ#. 
Although this case should not occur (since no 
other interrupts are enabled) it should be treated 
as a program fault during development. 


al 
v 


( Return from interrupt ) 


‘During early development, it is often better to notify the user instead of 


,actually suspending. 
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| SetupRequest :) 


‘ 


Select EPO Page (PAGESEL=0x00) 

Clear potential EPO Stall (EPRSPCLR=0x01) 

Clear any EPO Interrupts (EPIRQSTAT=Oxff) 

Clear addressing state variable (SettingAddress=FALSE) 


| 


Select Setup Page (PAGESEL=0xe0) 
Copy Setup Packet to local memory: 
bmRequestType = SETUPO 

bRequest = SETUP1 

wValue = SETUP3, SETUP2 
windex = SETUP5, SETUP4 
wLength = SETUP7, SETUP6 


Vv 
Clear Setup Packet Interrupt (IRQSTAT2=0x40) 
Select EPO Page (PAGESEL=0x00) 


This simple example 
only supports the 
requests shown, but 

with more programming, | 
any request can be 
supported .See USB 
Spec section 9.3 


SetAddress 


bmRequestType==0x00 ~ ”” Page 9 
bRequest==0x05 


bmRequestType==0x80 z= GetDevDesc | |_| 
bRequest==0x06 Page 6 
(HIBYTE)wValue==0x01 


bmRequestType==0x80 
bRequest==0x06 > GetConfDesc | |__| 


(HIBYTE)wValue==0x02 Page 7 


yoyedsiq jsenbey gsn 


bmRequestType==0x00 : ‘This is a non- 
bRequest==0x09 > SetConfi g standard request. 


Page 10 It is shown only to 
demonstrate Control 
bmRequestType==?? ; Write data transfers. 
bRequest==?? — | | ControlWrite | _| > 
Unknown or unsupported Page 10 
setup request / Default 
v Y 
Stall Endpoint 0 : Clear Control Status Phase Handshake 
(EPRSPSET=0x01) (EPRSPCLR=0x10) 
Allow NET2890 to ACK the status § | 
phase of the Control Transfer: Retu aa +) 
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4 GetDevDesc ) 


| 


Get address of Device Descriptor (TxBuf = &DevDesc) 
Determine transfer size (TxRemain = min (Sizeof(DevDesc), wLength)) 
Flush EPO FIFO (FIFOCTL |= 0x20) 


This call to EpO0TransmitPktwill 


load the EPO FIFO with the first : 
packet of the descriptor. When Ep0OTransm itPkt 
the host successfully reads the Page 8 


packet, and issues IN tokens for 
another packet, EpOHandler will 
re-use Ep0TransmitPkt to load 
the next packet. The process 


repeats until the entire descriptor 
is read. Return 


This Device Descriptor is 
preloaded in local memory. 
(See USB spec 9.6.1 for 
-content information.) Note 
that NET2890 endpoint 
configuration must match 
descriptors 


Device Descriptor 

(DevDesc): 
bLength 
bDescriptorType 
bcdUSB 
bDeviceClass 
bDeviceSubClass 
bDeviceProtocol 
bMaxPacketSize0 
idVendor 
idProduct 
bcdDevice 
iManufacturer 
iProduct 
iSerialNumber 
bNumConfigurations 
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i. GetConfDesc ; 


Get address of Configuration Descriptor (TxBuf = &ConfDesc) 
Determine transfer size (TxRemain = min (Sizeof(ConfDesc), wLength)) 
Flush EPO FIFO (FIFOCTL |= 0x20) 


This call to EpOTransmitPkt will 


load the EPO FIFO with the first 1 
packet of the descriptor. When Ep0Tran sm itPkt 
the host successfully reads the Page 8 


packet, and issues IN tokens for | 

another packet, EpOHandler will 

re-use Ep0TransmitPkt to load 
the next packet. The process 


repeats until the entire descriptor 
ee Return 


These descriptors are 
preloaded contiguously in 
local memory. (See USB 


spec 9.6.2 - 9.6.4 for - : 

content information.) Note ~~. Configuration 

that NET2890 endpoint Descriptor 

configuration must match (ConfDesc): 

descriptors bLength 

, bDescriptorType 

wTotalLength 
bNuminterfaces 
bConfigurationValue 
iConfiguration 
bmAttributes 
MaxPower 


Interface Descriptor: 
bLength 
bDescriptorType 
blInterfaceNumber 
bAlternateSetting 
bNumEndpoints 
binterfaceClass 
blInterfaceSubClass 
bInterfaceProtocol 
ilnterface 


Endpoint Descriptors: 
(One for each endpoint) 
bLength 
bDescriptorType 
bEndpointAddress 
bmAttributes 
wMaxPacketSize 
binterval 
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EpOTransmitPkt is called when the host is requesting a . 


packet, and it is 'safe' to load EPO transmit FIFO. ea Ep0TransmitPkt ) 


This section is similar to EpTransmitPkt . Differences 


mainly address errata 630-0057-0401 

Determine how many bytes to transmit (Count = min(TxRemain, EpOMaxPktSize)) 
Duplicate count (Count2 = Count) 
Reduce remaining transfer size (TxRemain -= Count) 


Done copying to FIFO 
(Count == 0) 
? 


No 

v 
Copy byte from local memory to FIFO (EPDIN = *TxBuf) 
Point to next byte in local memory(TxBuf++) 
Reduce count (Count--) 


‘As soon as the amount of data in 
the FIFO equals (or exceeds) the 
endpoint's maximum packet size, 
the NET2890 will respond to an IN 
token with a full packet instead of a 


FIFO loaded with 
less than EPO packet size 


(Count2 < EpOMaxPktSize) \NAK. 
? 
Yes 
i Setting FIFO Valid allows a_ short 
Set FIFO Valid (FIFOSTAT = 0x80) Reet ere renege nes 
No > Clearing the handshake variable 
Vv here ensures that the FIFO will not 


Clear EPO FIFO handshake variable (OkayToLoadEp0 = FALSE) | ~ eon euccessfully cont See 


EpOHandler , EpOPktSentHandler 
Return 


‘and errata 630-0057-0401 
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EpOPkSentHandleris called when EPO's Data Packet 


Transmitted Interrupt status bit is set. This bit gets set on 
two conditions: 


EpoPktSentHandler ) _ - the succesful Data Phase of a Control Read 


- the succesful Status Phase of a Control Write 
The 'Direction of transfer’ in bnRequestType determines 
which condtion applies. (This program does not need to 
differentiate between the conditions.) 


Clear endpoint's Data Packet Transmitted Status and 
Data IN Token Interrupt Status (EPIRQSTAT=0x14) 
Set EPO FIFO handshake variable (OkayToLoadEp0 = TRUE) 


__ Apacket has been successfully sent to the host. 

“If an IN token arrives after this time, it is safe to 
load the EPO Tx FIFO. See EpOHandler, 

Ep0OTransmitPkt and errata 630-0057-0401 


Processing Set Address request 
(SettingAddress==TRUE) 
? 


Yes 


v 


Select OURADDR in Index Register (IDXADDR1=0x01) 
Set our USB device address (OURADDR = (LOBYTE)wValue) 
Clear addressing state variable (SettingAddress=FALSE) 


( SetAddress +) 


‘Recall: SettingAddressis set to FALSE 
_” for every Setup Request. (See page 5) 


Vv / 
Set addressing state variable (SettingAddress=TRUE) 


USB specifies that a device cannot change it's 

address until after the associated status phase. 
(See USB spec section 9.4.6.) Return 
When the NET2890 successfully receives the,“ 
host's status phase (an IN) the NET2890 will ” 

interrupt with Data Packet Transmitted Interrupt 
Status set. This in turn causes EpOHandler and 

then EpOPktSentHandler to be called, which 

will finally set the device's address. 
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SetConfig ) 


Configuration value valid 
(LOBYTE)wValue<=DevDesc[bNumConfigurations] 
? 


) 


Yes 


v 


Copy configuration byte (CurrUsbConfig=(LOBYTE)wValue) 


Configured 
(CurrUsbConfig!=0 
? 


¥ 
Stall Endpoint 0 (EPRSPSET=0x01) 


No 


Yes 


v 
Device not configured (MAINCTL &= ~0x04) 


v 
Device configured (MAINCTL |=0x04) 


( ControlWrite ) 


Setup receive buffer (RxBuf = RXBUFFER) 
Setup receive transfer size (RxRemain = min(wLength, RXBUFFERSIZE) 
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EpOPktRevd Handler > EpOPktRevdHandler is called when EPO's Data Packet 
Received Interrupt status bit is set. This bit gets set on two 
conditions: 
- the succesful Data Phase of a Control Write 
- the succesful Status Phase of a Control Read 
The 'Direction of transfer' determines which condtion applies. 


Direction: Device to Host 


(bmRequestType[7] == 1) No 
? 
Control Write Data Phase 
Yes ReceivePkt 
Control Read Status Phase | Page 13 


Clear Data Packet Received Interrupt status (EPIRQSTAT=0x20) 


EpOHandler A 


This condition indicates that the host expects more data, and it 
‘is safe to load EPO Transmit FIFO. See errata 630-0057-0401 
v Ep0TransmitPkt and EpOPktSentHandler, for more 


Select EPO Page (PAGESEL=0x00) information. 


Data IN Token Interrupt AND EpOTransmitPkt 


m EPO FIFO handshake variable TRUE p 8 
a ((EPIRQSTAT[2] == 1) && OkayToLoadEp0) age 
= 
3 Data Packet Transmitted Interrupt —_» Ep0OPktSe ntHandler 
o (EPIRQSTAT[4]==1) Page 9 
S) 
2 
xe} 
= Data Packet Received Interrupt ———> EpOPktRevd Handler 
7 (EPIRQSTAT[5]==1) This Page 
This simple example does not handle other endpoint 


interrupt events. See EPIRQSTATand EPIRQENBfor more 


Default information. 
He All enabled interrupts must have handlers. If the source Retu m 
of an enabled interrupt is not cleared (by writing a '1' to 


PROGRAM ; pape ; 
FAULT!! appropriate bits in EPIRQSTAT) the NET2890 will not de- 
assert IRQ#. 
Although this case should not occur (since no other 
interrupts are enabled) it should be treated as a program 
fault during development. 
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EpAHandler + ‘EpAHandler is called when Endpoint A 


Interrupt status bit is set. 


Endpoint A in this example is configured as 
,an OUT endpoint. 
Vv 
Select EPA Page (PAGESEL=0x20) 
Vv 
ReceivePkt 
Page 13 
Return 
EpBHandler + /EpBHandler is called when Endpoint B 
\ Interrupt status bit is set. 
Endpoint B in this example is used as an IN 
endpoint. 
Vv 
Select EPB Page (PAGESEL=0x40) 
Vv 
TransmitPkt 
Page 14 
Return 
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Note that in this ‘artificial’ device, there is * | 
no mechanism (such as a MODEM) to 

remove data from receive buffers. Once a | 

buffer and it's associated endpoint FIFOs 

are full, OUTs to that endpoint are NAKd. 


v 


ReceivePkt ) { 


.tokens as long as this bit is set. 


ReceivePktis called in response to a Data 
Packet Received Interrupt Status bit being 
set. Note that the endpoint will NAK OUT 


Reduce size of remaining transfer (RxRemain -= Count) 


Determine how many bytes to copy to memory (Count=min(RxRemain, FIFOCNT)) 


v 


If there is room in the endpoint's 
_ FIFO, the NET2890 can now 
accept another OUT data packet. 


Clear endpoint's Data Packet Received Interrupt Status (EPIRQSTAT=0x20) 


Done copying to memory 
(Count == 0) 
? 


(Hint: For performance, this 
section should be optimized 
and written in assembler.) ni 


Reduce count (Count--) 


Yes [Copy byte from FIFO to local memory (*RxBuf=EPDOUT) 
Point to next byte in local memory(RxBuf++) 


13 
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In this ‘artificial device, there is», . TransmitPkt is called in response to 
no mechanism (such as a MODEM) { TransmitPkt :) Data Packet Transmitted Interrupt 
to fill transmit buffers. Once a Status bit being set . Note that the 
transmit buffer and it's associated endpoint will NAK IN tokens as long 
endpoint become empty, IN tokens as this bit is set. 
are NAKd. | 


Vv 
Clear endpoint's Data Packet Transmitted Interrupt Status (EPIRQSTAT=0x10) 


To remove any ambiguity, this tests \.Ifat any time after this bit is cleared FIFOCNT 
checks if any more data needs to be ‘. equals or exceeds the endpoint's maximum 
copied from local memory to the packet size (or FIFO Valid is set) the NET2890 


transmit FIFO. The transfer is not 

really done until the host successfully 

reads the last packet from the 
endpoint's FIFO — 


will respond with packet data instead of a NAK. 


Transfer done 
(TxRemain == 0) 
2 


No 

v 
Calculate remaining space in FIFO (FifoRemain=128-FIFOCNT) 
Determine how many bytes to transmit (Count=min(TxRemain, FifoRemain)) 
Reduce remaining transfer size (TxRemain -= Count) 


Done copying to FIFO 
(Count == 0) 
? 


(Hint: For performance, 
this section should be 
Yes optimized and written in No 
assembler.) | 


Copy byte from local memory to FIFO (EPDIN = *TxBuf) 
Point to next byte in local memory(TxBuf++) 
Reduce count (Count--) 


Yes 
Transfer done No ee \ ‘(As soon as the amount of data 
TxRemain == | nie Oele ‘in the FIFO equals or exceeds 
( 9 ) remains in local ‘the endpoint's maximum packet 
( MEMOry, size, the NET2890 will respond 
to an IN token with a full packet 
Yes instead of a NAK. 
v (Setting FIFO Valid 
Set FIFO Valid (FIFOSTAT=0x80) allows a_ short packet 
to be returned to the 
host 
Return 
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EpAlnit ) Configure Endpoint A to be a 64-byte 


‘BULK OUT endpoint at USB endpoint 
| address 1 (0x01) 


Select Endpoint A's Paged Register Set (PAGESEL=0x20) 

Clear Timeout, Short Packet Transferred, and all USB STALL, NAK and ACK status bits (EPUSBSTAT=Oxfe) 
Clear FIFO Overflow, Underflow, Full and Empty (FIFOSTAT=0x3c) 

Set FIFO Valid Mode and FIFO Flush (FIFOCTL=0x60) 

Select EPAPKTSIZLSB in Index Register (IDXADDR1=0x12) 

Assign EPA maximum packet size (IDXDATA1=0x40) 

Assign Endpoint Number 1 1, Direction to OUT, Type to BULK, and Endpoint Enable to TRUE 

Set Data Packet Received Interrupt enable (EPIRQENB=0x20) 

Clear Data Packet Received Interrupt status (EPIRQSTAT=0x20) 


Vv 
Setup receive buffer (RxBuf = RXBUFFER) 
Setup receive transfer size (RxRemain = RXBUFFERSIZE) 


EpB Init ) Configure Endpoint B to be a 64-byte 


_ BULK IN endpoint at USB endpoint 
| address 2 (0x82) 


Select Endpoint B's Paged Register Set (PAGESEL=0x40) 

Clear Timeout, Short Packet Transferred, and all USB STALL, NAK and ACK status bits (EPUSBSTAT=Oxfe) 
Clear FIFO Overflow, Underflow, Full and Empty (FIFOSTAT=0x3c) 

Set FIFO Valid Mode and FIFO Flush (FIFOCTL=0x60) 

Select EPBPKTSIZLSB in Index Register (IDXADDR1=0x14) 

Assign EPB maximum packet size (IDXDATA1=0x40) 

Assign Endpoint Number to 2, Direction to IN, Type to BULK, and Endpoint Enable to TRUE (EPCFG=0x2e) 
Set Data Packet Transmitted Interrupt Enable (EPIRQENB=0x40) 

Clear Data Packet Transmitted Interrupt status (EPIRQSTAT=0x40) 


Setup transmit buffer (TxBuf = TXBUFFER) 
Setup transmit transfer size (TxRemain = TXBUFFERSIZE) 


© NetChip Technology, Inc., 1997 15 
335 Pioneer Way, Mountain View, California 94041 
TEL (650) 526-1490 FAX (650) 526-1494 
http:/www.netchip.com 


Sample Enumeration Sequences 


Note: The following enumeration sequences were recorded 


from a working NET2890-EB evaluation board with a 
Windows98 host. These sequences are provided as 
examples only. 


No Driver installed in host 


Reset 

Get Device Descriptor - 64 bytes 
Reset 

Set Address 

Get Device Descriptor - 18 bytes 


Get Configuration Descriptor - 255 bytes 
Get String Descriptor - 255 bytes 
DialogBox installation wizard pop-up 


NcUsb.sys installed in host 


Reset 

Get Device Descriptor - 64 bytes 
Reset 

Set Address 

Get Device Descriptor - 18 bytes 


Get Configuration Descriptor - 255 bytes 
Get Device Descriptor - 18 bytes 

Get Configuration Descriptor - 265 bytes 
Set Configuration 
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USB Compatibility Ch. 9 Test 


Reset 

Get Device Descriptor - 64 bytes 

Reset 

Set Address 

Get Device Descriptor - 18 bytes 

Get Configuration Descriptor - 9 bytes 
Get Configuration Descriptor - 255 bytes 
Get Device Descriptor - 18 bytes 
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